home *** CD-ROM | disk | FTP | other *** search
/ NOVA - For the NeXT Workstation / NOVA - For the NeXT Workstation.iso / Apps / AudioApps / CSound.app / manual / soundin < prev    next >
Encoding:
Text File  |  1992-12-21  |  2.2 KB  |  56 lines
  1. .nf
  2. a1            \fBsoundin\fR    ifilno[, iskptim]
  3. a1, a2            \fBsoundin\fR    ifilno[, iskptim]
  4. a1, a2, a3, a4     \fBsoundin\fR    ifilno[, iskptim]
  5.             \fBout\fR        asig
  6.             \fBouts1\fR        asig
  7.             \fBouts2\fR        asig
  8.             \fBouts\fR        asig1, asig2
  9.             \fBoutq1\fR        asig
  10.             \fBoutq2\fR        asig
  11.             \fBoutq3\fR        asig
  12.             \fBoutq4\fR        asig
  13.             \fBoutq\fR        asig1, asig2, asig3, asig4    
  14. .fi
  15.  
  16. These units read from and write to an external sound-file device.
  17.  
  18.  
  19. INITIALIZATION
  20.  
  21. \fIifilno\fR - integer suffix (n) of a binary file named 'soundin.n',
  22. assumed to be in the directory SFDIR (see also GEN01).
  23. This is normally a soundfile (with header), whose samples may be either
  24. shorts or floats.
  25. If the file has no soundfile header, they are assumed floats.
  26.  
  27. \fIiskptim\fR (optional) - time in seconds of input sound to be skipped.
  28. The default value is zero.
  29.  
  30.  
  31. PERFORMANCE
  32.  
  33. \fBsoundin\fR is functionally a signal generator that happens to derive
  34. its signal from a pre-existing file.  The number of channels read in
  35. is set by the number of result cells, a1, a2, etc.
  36. A \fBsoundin\fR unit opens this file whenever the host instrument is
  37. initialized, then closes it again each time the instrument is turned off.
  38. There can be any number of \fBsoundin\fR units within a single instrument
  39. or orchestra; also, two or more of them can read simultaneously from the
  40. same external file.
  41.  
  42. \fBout, outs, outq\fR, on the other hand, do not deal directly with an
  43. external sound file, but send audio samples to an accumulating output
  44. buffer (created at the beginning of performance) which serves to collect
  45. the output of all active instruments before the sound is written to disk.
  46. There can be any number of these output units in an instrument.  The type
  47. (mono, stereo, or quad) must agree with \fBnchnls\fR, but units can be
  48. chosen to direct sound to any particular channel:  \fBouts1\fR sends to
  49. stereo channel 1, \fBoutq3\fR to quad channel 3, etc.
  50.  
  51. Soundfile statements are most commonly used in direct sound generation.
  52. However, they also lend themselves to the standard studio tasks of mixing,
  53. splicing, editing, post reverberating, etc.  By doing these operations
  54. digitally, the problem of accumulated analog tape noise is thus avoided.
  55. .bp
  56.